LassoScript Utility
Basics Browse Detail

[OS_Process->Read]

Tag Link [OS_Process->Read] Category OS Process
Type Member Source Available Yes
Support Preferred Version 8.5
Change New Data Source Any
Output Type Bytes Security None
Implementation Sets Lasso 8.5

Description

[OS_Process->Read] reads any available data from the standard output of the native process and returns a byte stream. This tag accepts two parameters. The first specifies the maximum number of bytes of data to retrieve. The tag will return all available data up to that number of bytes. By default all available data will be retrieved. A -Timeout parameter specifies the time in seconds which the tag should wait for output to become available. If no data is available before the read times out then an empty byte stream is returned.

No character set translation is performed on the output of this type. A raw byte stream is always returned.

Syntax

Var: 'myProcess' = (OS_Process: '/bin/cat');
$myProcess->(Write: 'This is a test\n');
$myProcess->CloseWrite;
encode_html: $myProcess->Read;
$myProcess->Close;

Parameters

Optional Parameters
Length The maximum length in bytes of data to read from the native process.
-Timeout The maximum time to wait in seconds for data to become available for reading.

Examples

See the Lasso 8 Language Guide for examples of how to use this tag.